.TH E1432_SET_LBUS_MODE 3 E1432
.SH NAME
.nf
e1432_set_lbus_mode \- Set mode for Local Bus
e1432_get_lbus_mode \- Get current mode for Local Bus 
.fi
.IX e1432_set_lbus_mode(3) 3
.IX e1432_get_lbus_mode(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_lbus_mode(E1432ID hw, SHORTSIZ16 ID,
                               SHORTSIZ16 mode)
SHORTSIZ16 e1432_get_lbus_mode(E1432ID hw, SHORTSIZ16 ID,
                               SHORTSIZ16 *mode)
.cE
.SH DESCRIPTION

\fIe1432_set_lbus_mode\fR sets the Local Bus to one of five settings:
\fIappend\fR, \fIgenerate\fR, \fIinsert\fR, \fIpipe\fR, or
\fIconsume\fR.

\fIe1432_get_lbus_mode\fR returns the current setting.

This parameter is a "global" parameter.  It applies to an entire E1432
module rather than to one of its channels.  The \fIID\fR parameter is
used only to identify which module the function applies to, and all
channels in that module will report the same value for this parameter.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fImode\fR must be one of the following:

\fBE1432_LBUS_MODE_GENERATE\fR causes the module to ignore and throw
away any data that comes in (from the left) and to send its own data
out (to the right).  The local bus data stream is \fIgenerated\fR by
the module.

\fBE1432_LBUS_MODE_PIPE\fR causes the module to send out all data that
comes in.  No additional data generated by the module is added to the
local bus data stream.  The local bus data stream is \fIpiped\fR
through the module.

\fBE1432_LBUS_MODE_INSERT\fR causes the module to send out its own
data, followed by all data that comes in.  The module's data is
\fIinserted\fR at the beginning of the local bus data stream.

\fBE1432_LBUS_MODE_APPEND\fR causes the module to send out all data
that comes in, followed by its own data.  The module's data is
\fIappended\fR to the end of the local bus data stream.

\fBE1432_LBUS_MODE_CONSUME\fR causes the module to keep the data that
comes in, and not send any data out.  The local bus data stream is
\fIconsumed\fR by this module.
.SH "RESET VALUE"
After a reset the Local Bus is set to \fBE1432_LBUS_MODE_PIPE\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_reset_lbus, e1432_set_data_port
.ad
